home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / language / turboass.lzh / READ_ME.TXT < prev    next >
Text File  |  1986-02-06  |  23KB  |  501 lines
  1.                              Turbo-Ass V1.1
  2.                               ©1989 Σ-soft
  3.                     von Markus Fritze & Sören Hellwig
  4.  
  5. 1.1 Einleitung
  6. Nach   langem   hin   und   her   haben   wir  uns  entschlossen  unser
  7. Assembler-Paket  als  Shareware  auf den Markt zu werfen. Der Assembler
  8. wurde  vormals durch OMIKRON.Software unter dem Namen OMIKRON.Assembler
  9. verkauft.  Die Shareware-Version ist jedoch eine erweiterte Version des
  10. OMIKRON.Assemblers.  Sie  enthält  weniger Fehler, weitere Features und
  11. ist  noch  ein  wenig  schneller. Zum Paket gehört (natürlich) auch ein
  12. Debugger,  der Bugaboo (vormals OMIKRON.Debugger). Somit kann nun jeder
  13. User  in  den Genuß eines schnellen und leistungsfähigen Assemblers und
  14. Debuggers kommen; zumal es zwar viele Programmiersprachen als Shareware
  15. bzw. PD gibt, aber noch keinen (vernünftigen) Assembler.
  16.  
  17. DIE  FIRMA  OMIKRON.SOFTWARE  HAT  NICHTS MIT DIESEM ASSEMBLER-PAKET ZU
  18. TUN.  Σ-SOFT  IST  ALLEINIGER  INHABER  ALLER  RECHTE  AM ASSEMBLER UND
  19. DEBUGGER!
  20.  
  21. Dieser  Text  ist  nicht  als  eine  Anleitung gedacht, sondern nur als
  22. Kurzeinführung  in den Assembler. Die vollständig Anleitung auf ca. 240
  23. Seiten gibt es bei den Autoren.
  24. Zur  Not  kann auch das ST-Magazin 11/89 und 12/89 herangezogen werden.
  25. Dort hat die Referenzkarte den Assembler und Debugger zum Thema.
  26.  
  27. Nachtrag:  Es fehlen ziemlich viele Features in diesem READ_ME, es wird
  28.            mir einfach zu viel... (Markus)
  29.  
  30. 1.2 Features des Turbo-Ass
  31. -Einfache und durchdachte (!) Bedienung.
  32. -Der Assembler übersetzt durchschnittlich 1 300 000 Zeilen pro Minute.
  33. -Syntax-Check bereits bei der Eingabe. Teilweise sogar Semantik-Check!
  34.  Es  werden  sowohl  Tippfehler, wie auch doppelt vergebene Symbolnamen
  35.  bereits bei der Eingabe gemeldet.
  36. -Viele  besonders  leistungsfähige  Funktionen  des Editors, z.B. Suche
  37.  von  Symbolen,  Ersetzen  von  Symbolen,  Einklappen vonProgrammteilen
  38.  (wie in GFA-Basic 3.0), u.v.a.m.
  39. -Fantastische Kombination von Debugger und Assembler. Bei einem Absturz
  40.  eines  Programms  im  Debugger  kann  der  Assembler  automatisch  die
  41.  Absturzadresse in eine Zeilennummer umrechnen!!!
  42. -Eigene   Tastatur-  und  Bildschirmtreiber  =>  selbst  bei  härtesten
  43.  Programmabstürzen funktionieren Assembler und Debugger noch.
  44. -KEINE Makros!!!
  45. -u.v.a.m.
  46.  
  47. 1.3 Was ist Shareware
  48. -Jeder  kann/darf/muß/soll  den  Turbo-Ass kopieren! Dabei sollten aber
  49.  stets ALLE (!) Dateien mitkopiert werden.
  50. -Wem den Assembler gefällt, sollte uns fairerweise 50DM überweisen. Das
  51.  hat für alle Parteien vorteile:
  52.  
  53.  Für uns:
  54.  -Wir  arbeiten  nicht ganz umsonst (im Turbo-Ass stecken 3 "Mannjahre"
  55.   Arbeit)
  56.  
  57.  Für den User:
  58.  -Er bekommt eine 240 Seiten starke Anleitung
  59.  -Er bekommt die neuste Version mit persönlicher Seriennummer
  60.  -Er bekommt das erste Update kostenlos
  61.  -Er erhält bei gefundenen Fehlern eine fehlerfreie Version
  62.  -Er kann sich bei Problemen an uns wenden
  63.  -Er  bekommt  für  jeden User, der bei Registierung seine Seriennummer
  64.   angibt,   10DM   (allerdings   maximal   10  mal,  wir  wollen  keine
  65.   PD-Vertriebe  finanzieren).  Das  Geld  ist also eine "Entschädigung"
  66.   für das Vorführen des Assemblers und das Kopieren.
  67.  -Nochmal:  Läßt  sich jemand registrieren, so gibt er die Seriennummer
  68.   des  vorher  benutzen Assemblers an. Der User, dem diese Seriennummer
  69.   gehört, bekommt vom uns 10DM. Alles klar?
  70.  
  71. Wer diese Angebot annehmen will, wende sich bitte an:
  72.  
  73.                 Markus Fritze
  74.                 Birkhahnkamp 38
  75.                 2000 Norderstedt 1
  76.                 Tel: 040/5223955
  77.                      (ab 18Uhr, auch am Wochenende (NIE VOR 12UHR!!!))
  78.                 BLZ: 20069111, Norderstedter Bank
  79.                      Kontonummer: 407860
  80.  
  81. Ich  bitte  allerdings  teilweise um etwas Geduld; ich hoffe die meiste
  82. Post  am  selben  Tag zu erledigen, wenn aber keine Anleitungen mehr da
  83. sind  oder  wenn  wir gerade einige Neuerungen  implementieren, kann es
  84. schon  mal  etwas  dauern (Wenn nach 2-3 Wochen allerdings nix passiert
  85. kann eine Anfrage klären, ob die Post auch angekommen ist).
  86.  
  87.  
  88. 1.4 Hardwarevorraussetzungen
  89. Atari  ST mit 512k, wobei allerdings erst ab 1Mb Assembler und Debugger
  90. gemeinsam  im  RAM  gehalten  werden können, was seinerseits wieder ein
  91. sehr  wirksames  Debugging  erst  ermöglicht. Die hohe Auflösung bietet
  92. sich   wohl   eher   an,   als  die  mittlere  Auflösung  (Ist  einfach
  93. augenfreundlicher);  aber der Turbo-Ass läuft sowohl in Farbe, wie auch
  94. in S/W.
  95.  
  96. 1.5 Installation
  97. TURBOASS.PRG,  TURBOASS.CFG, TURBOASS.DAT, BUGABOO.PRG und CALL.PRG auf
  98. eine Disk, bzw. in einen Ordner kopieren. Das war's.
  99.  
  100. 1.6 Zu den Autoren
  101. Sören  Hellwig und ich (Markus Fritze) sind zur Zeit beide 21 Jahre alt
  102. (nein,  nicht  zusammen...)  und studieren technische Informatik an der
  103. FH-Wedel  bei  Hamburg.  Deswegen  bitte  wir  auch  teilweise um etwas
  104. Geduld,  wenn  Anfragen  nach  Updates,  etc.  kommen; das Studium geht
  105. leider vor. Zudem beantworte ich jeden Brief, der Rückporto beinhaltet.
  106. Post  ohne  Rückporto  wird  nur  in  Ausnahmefällen  beantwortet  (Zur
  107. Registrierung ist KEIN Rückporto nötig!)
  108.  
  109. 1.7 Haftung/Rechte
  110. Alle  Rechte  am  Turbo-Ass  liegen  bei  Σ-soft.  Wobei  jeder  seinen
  111. Assembler  beliebig  kopieren  darf.  Auch  das Upload in Mailboxen ist
  112. erlaubt.  Der  Turbo-Ass  und  das Handbuch wurden mit größter Sorgfalt
  113. erstellt.  Leider  sind  Fehler nie auzuschließen, deswegen möchten wir
  114. sie   darauf   hinweisen,   daß   wir   weder  eine  Garantie  für  die
  115. Fehlerfreiheit  geben, noch die Haftung für irgendwelche Folgen, gleich
  116. ob  durch  Fehler  im  Handbuch,  in  der Software oder in der Hardware
  117. verursacht,  übernehmen  können.  Es wird wohl jeder verstehen, daß wir
  118. keine  besondere  Begeisterung  verspüren,  wenn  jemand behauptet, der
  119. Assembler  habe  im seine Platte mit Sourcetexten im Werte von mehreren
  120. Millionen  Mark  zerstört,  uns auf Schadenersatz verklagen will. Also:
  121. Benutzung  auf  eigene  Gefahr!  (Dieser  Abschnitt gilt wohl bei allen
  122. Softwarefirmen.
  123.  
  124.  
  125. 2 Der Assembler
  126.  
  127. 2.1 Benutzeroberfläche
  128. Die  Benutzeroberfläche  ist  nicht  von  GEM  o.ä.  abhängig, d.h. neu
  129. programmiert,  das  hat  den  Vorteil, daß der Assembler sicherer gegen
  130. Abstürze  und  auch  schneller ist. Zudem konnten einige nette Features
  131. implementiert werden. Trotzdem sollte die Umstellung von GEM wohl nicht
  132. ins  Gewicht fallen. Die kleinen Buchstaben in den Buttons bewirken mit
  133. ALT zusammen gedrückt, das Anklicken des Buttons wie mit der Maus.
  134.  
  135. 2.2 Die Maus im Assembler
  136. Man  kann  mit  der Maus eine ganze Menge Dinge machen, hier sei jedoch
  137. nur die Benutzung im Assembler erklärt:
  138.  
  139. Im Sourcetext:
  140. Linke Maustaste:
  141. Einfachklick: Cursor setzen
  142. langer Klick: Block markieren (mit Scrollen)
  143. Doppelklick : Sprung zur Definition des angeklickten Symbols
  144.  
  145. Rechte Maustaste:
  146. Einfachklick: Sourcetext scrollen (nur am Rand klicken!)
  147. Doppelklick : Formel in den Rechner übernehmen
  148.  
  149. In der Statuszeile:
  150. einfach alles mal mit links bzw. rechts anklicken...
  151.  
  152. 2.3 Der Editor
  153. Jede  eingegebene Zeile wird automatisch auf ihren Syntax und teilweise
  154. auch  auf  die  Semantik überprüft. Wenn die Zeile fehlerfrei ist, wird
  155. sie  sofort  formatiert ausgegeben. Bei einem Eingabefehler wird in der
  156. Statuszeile die Fehlermeldung angezeigt.
  157.  
  158. 2.4 Besonderheiten
  159. Als Adressierungsart wird auch "absolut short" direkt unterstützt. Dazu
  160. ist  hinter  der  Adresse  ".w"  anzugeben.  Line-A-Routinen können mit
  161. "LINEA #Nummer" eingegeben werden. Der Assembler wandelt nicht-Motorola
  162. Eingaben wenn möglich automatisch in das Motorola-Format um.
  163.  
  164. 2.5 Optimierungen
  165. Der  Assembler  kann  einige  Optimierungen  selbstständig finden. Dazu
  166. gehören:
  167. Absolut lang    -> relativ
  168. relativ         -> relativ short
  169. Absolut lang    -> PC-relativ
  170. MOVE.L #xx,A0   -> LEA xx,A0 (wenn dannach PC-relativ was bringt)
  171. MOVE.L #xx,-(SP)-> PEA xx,A0 (wenn dannach PC-relativ was bringt)
  172. Ferner  werden  einige für C-Compiler typische Sprünge gefunden (z.B. 2
  173. aufeinanderfolgende BRA, wobei das 2.BRA nie angesprungen werden kann)
  174. Wenn der Assembler opt